home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl120 / ccolor13.lzh / CCOLOR.DOC next >
Text File  |  1991-07-24  |  48KB  |  2,013 lines
  1. CCOLOR: IBM PC Conference Color
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.              ---------------------------------
  24.               CCOLOR: IBM PC Conference Color
  25.              ---------------------------------
  26.              Communications Accessory
  27.              ---------------------------------
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.     CCOLOR is distributed freely and may be copied by anyone for any
  36.     number of machines.  The author offers CCOLOR as "shareware".  If
  37.     the program is found to be useful or entertaining, a registration
  38.     of $50.00 is required.    The author may be reached at:
  39.  
  40.  
  41.                  CABER Software
  42.                  R. (Scott) McGinnis
  43.                  P.O. Box 3607 Mdse Mart
  44.                  Chicago, IL 60654-0607
  45.  
  46.                  PLINK, GEnie id: TARTAN
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 1.3: 910724
  61.  
  62. CCOLOR: IBM PC Conference Color
  63.  
  64.  
  65.  
  66.     CCOLOR version 1.3 is copyright 1991 CABER Software (R.  Scott
  67.     McGinnis).  All rights are reserved world wide, excepting redistri-
  68.     bution under the ShareWare concept.  CCOLOR is distributed freely
  69.     and may be copied by anyone for any number of machines, under the
  70.     ShareWare concept.  Restrictions on redistribution are discussed in
  71.     the accompanying document VENDOR.DOC.
  72.  
  73.  
  74.     CCOLOR is distributed as ShareWare.  You may use CCOLOR without
  75.     charge for the purposes of evaluating its usefulness.  It is sug-
  76.     gested that this evaluation period be limited to a few days of actual
  77.     use.  If you find CCOLOR to be worth continued use, then you must
  78.     pay for it.  Please complete the form REGISTER.DOC and mail it with
  79.     your payment.
  80.  
  81.  
  82.     Registration of CCOLOR includes COM-AND and all published accessory
  83.     programs (which currently are PC-VCO, CCHESS, CBRIDGE, and CCOLOR),
  84.     and several utilities (unPACKIT and unSTUFIT).    COM-AND, accessories,
  85.     and utilities are published separately.  One registration covers the
  86.     use of any and all of these programs.
  87.  
  88.  
  89.     By registering your copy of CCOLOR (or any ShareWare product), you
  90.     are promoting and supporting the convenient distribution method and
  91.     free evaluation policy that brought you this copy of CCOLOR.
  92.  
  93.  
  94.     If you have received this copy from a Users' Group, "Software
  95.     Library" or "SIG", and have paid a small fee (usually $3 to $10),
  96.     you have NOT acquired a registration or continued right to use
  97.     CCOLOR.  This fee was for the convenience of obtaining the diskette
  98.     with CCOLOR on it.  The fee does NOT apply to the registration fee.
  99.  
  100.  
  101.     You may NOT distribute CCOLOR or its documentation in connection
  102.     with ANY commercial venture, product, publication or service without
  103.     written approval.  CCOLOR may not be disassembled or modified
  104.     without express written consent of its author.
  105.  
  106.  
  107.     CCOLOR is supplied "as-is" with no warranties expressed or implied.
  108.     Neither CABER Software nor the author will be liable for any damages
  109.     or lost revenues incurred through the use of this program or any of
  110.     its accessories and utilities beyond the registration price paid.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. Version 1.3: 910724
  122.  
  123. CCOLOR: IBM PC Conference Color
  124.  
  125.  
  126.  
  127.     COM-AND and its accessories are available as shareware through
  128.     PLINK, GEnie, UNISON, NWI, Delphi and CIS.  They are also available
  129.     through many Bulletin Board systems.  Individuals are welcome to
  130.     download COM-AND and its accessories for purposes of evaluation, and
  131.     to upload them (in entirety) to Bulletin Board systems.
  132.  
  133.     Commercial users of COM-AND must register them with the author or one
  134.     of the individuals listed on this page.  Site licenses (multiple copy
  135.     registrations) are available from:
  136.  
  137.         CABER Software
  138.         R. (Scott) McGinnis
  139.         P.O. Box 3607 Mdse Mart
  140.         Chicago, IL 60654-0607
  141.  
  142.         PLINK, GEnie, Delphi ID: TARTAN
  143.         CIS id: 73147,2665
  144.  
  145.     A COM-AND BBS (using a version of COM-AND's BBS script) is operated
  146.     by SupportWare of Long Beach, CA.  SupportWare is licensed to nego-
  147.     tiate COM-AND commercial and site licenses, and provide COM-AND
  148.     support.  SupportWare offers considerable expertise in the field of
  149.     communications consultation.  Contact SupportWare through:
  150.  
  151.         SupportWare
  152.         Mike Todd
  153.         P.O. Box 14927
  154.         Long Beach, CA 90803-1449
  155.  
  156.         Voice: (213) 439-6104
  157.         BBS:   (213) 439-7714 (1200/2400 8n1)
  158.  
  159.     In Japan, COM-AND may be downloaded as shareware from PC-VAN.  It
  160.     is also available in Japan as a commercial product tailored for
  161.     specific machines through:
  162.  
  163.         Discotel Japan (Ciari Soft)
  164.         Kurakuen 3 ban-cho 2-50
  165.         Nishinomiya 662
  166.         Japan
  167.  
  168.         Contact: Claude Ciari
  169.         Tel (0798)73-0052
  170.         PC-VAN NEC by Ciari
  171.         ID: CCIARI
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Version 1.3: 910724
  183.  
  184. CCOLOR: IBM PC Conference Color
  185.  
  186.  
  187.     THE ASSOCIATION OF SHAREWARE PROFESSIONALS (ASP)
  188.  
  189.         ┌─────────┐
  190.       ┌─────┴───┐      │          (R)
  191.     ──│        │o      │──────────────────
  192.       │   ┌─────┴╨──┐ │  Association of
  193.       │   │     │─┘  Shareware
  194.       └───│    o    │    Professionals
  195.     ──────│    ║    │────────────────────
  196.           └────╨────┘    MEMBER
  197.  
  198.  
  199.     In 1987 Shareware authors founded the Association of Shareware
  200.     Professionals (ASP).  In forming this industry association, these
  201.     Shareware authors had several primary goals in mind, including:
  202.  
  203.        .  To inform users about Shareware programs and about Shareware as
  204.           a method of distributing and marketing software.
  205.  
  206.        .  To foster professionalism amongst Shareware authors by setting
  207.           programming, marketing, and support standards for ASP members.
  208.  
  209.        .  To encourage broader distribution of Shareware through user
  210.           groups and disk dealers who agree to identify and explain the
  211.           nature of Shareware.
  212.  
  213.        .  To provide a forum through which ASP members may communicate,
  214.           share ideas, and learn from each other.
  215.  
  216.     ASP OMBUDSMAN STATEMENT
  217.  
  218.     CABER Software (R.  Scott McGinnis) is a member of the Association of
  219.     Shareware Professionals (ASP).    ASP wants to ensure that the Share-
  220.     ware principle works for you.  If you are unable to resolve a Share-
  221.     ware-related problem with an ASP member by contacting the member
  222.     directly, ASP may be able to help.  The ASP Ombudsman can help you
  223.     resolve a dispute or problem with an ASP member, but does not provide
  224.     technical support for members' products.
  225.  
  226.     Please write to the ASP Ombudsman at:
  227.  
  228.        ASP Ombudsman
  229.        Association of Shareware Professionals
  230.        545 Grover Road
  231.        Muskegon, MI  49442-9427
  232.  
  233.     or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  234.     70007,3536.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. Version 1.3: 910724
  244.  
  245. CCOLOR: IBM PC Conference Color
  246.  
  247.  
  248.  
  249.                  Table of Contents
  250.                  -----------------
  251.  
  252.  
  253. I.    Introduction  .............................................. page 1
  254.  
  255.     A. What is CCOLOR .......................................... page 1
  256.     B. This program ............................................ page 1
  257.     C. This document ........................................... page 1
  258.  
  259. II.    Running the program  ....................................... page 2
  260.  
  261.     A. Loading through COM-AND ................................. page 2
  262.     B. Loading CCOLOR directly ................................. page 3
  263.     C. Loading CCOLOR Piggyback ................................ page 4
  264.  
  265. III.    CCOLOR Display    ............................................ page 5
  266.  
  267. IV.    Services supported ......................................... page 6
  268.  
  269.     A. PLINK IDs and handles ....................................page 7
  270.     B. GEnie IDs and handles ....................................page 7
  271.     C. SOURCE IDs and aliases (now defunct) .....................page 7
  272.     D. CIS handles ............................................. page 8
  273.     E. Delphi IDs and handles ...................................page 8
  274.     F. TBBS IDs ................................................ page 9
  275.     G. PROTOCALL IDs and handles (now defunct) ..................page 9
  276.  
  277. V.    CCOLOR Commands using COM-AND .............................. page 10
  278.  
  279. VI.    CCOLOR Commands Standalone ................................. page 12
  280.  
  281. VII.    CCOLOR Main Menu ........................................... page 13
  282.  
  283.     A. Controls ................................................ page 14
  284.     B. Settings ................................................ page 14
  285.     C. Notes ................................................... page 14
  286.  
  287. VIII.    The Notes file ............................................. page 15
  288.  
  289. IX.    Manual mode ................................................ page 16
  290.  
  291. X.    Automatic mode ............................................. page 17
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Version 1.3: 910724
  305.  
  306. CCOLOR: IBM PC Conference Color
  307.  
  308.  
  309.  
  310.             Table of Contents (continued)
  311.             -----------------------------
  312.  
  313.  
  314. XI.    Program Configuration (Alt-S, and Alt-P) ................... page 18
  315.  
  316.     A. Setup Screen (Alt-S) .................................... page 18
  317.     B. Communications Parameters (Alt-P) ....................... page 20
  318.     C. Colors (Alt-J) .......................................... page 21
  319.  
  320. XII.    Program Requirements ....................................... page 22
  321.  
  322. XIII.    Program and Author Information    ............................ page 23
  323.  
  324.  
  325.  
  326.                 Appendices
  327.                 ----------
  328.  
  329.  
  330. A.    Switches and Parameters .................................... page 24
  331.  
  332. B.    Files ...................................................... page 26
  333.  
  334. C.    Note file format ........................................... page 27
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Version 1.3: 910724
  366.  
  367. CCOLOR: IBM PC Conference Color                      Page   1
  368.  
  369.  
  370. I.    Introduction
  371.  
  372.  
  373.     A. What is CCOLOR?
  374.  
  375.  
  376.        CCOLOR for the IBM PC is an accessory program, intended to be
  377.        used with a 'base' communications program.  CCOLOR is integrated
  378.        into the comm program 'COM-AND'.  However, CCOLOR may be used
  379.        with any comm program supporting a 'DOS shell' that does not
  380.        break an established comm link (that does not drop DTR).
  381.  
  382.  
  383.        CCOLOR, used with network conferencing services such as People-
  384.        Link's PARTY, GEnie's RTC conferencing and CompuServe's CB,
  385.        follows the conversation, and assigns different colors to each
  386.        of the speakers.  The effect must be seen to be comprehended.
  387.  
  388.  
  389.     B. This program
  390.  
  391.  
  392.        CCOLOR Version 1.3 uses the CGA and EGA color adapters.  It may
  393.        be used on a monochrome adapter, but, of course, most of the
  394.        effect is lost.  A Microsoft Mouse is supported, if available.
  395.  
  396.  
  397.        CCOLOR may be copied freely and distributed to anyone for any
  398.        number of machines.    The author offers CCOLOR as "shareware".  If
  399.        the program is found to be useful or entertaining, registration
  400.        is required.  CCOLOR will be extended and enhanced if response
  401.        warrants.
  402.  
  403.  
  404.     C. This document
  405.  
  406.  
  407.        This document describes the features of CCOLOR.   It will not
  408.        attempt to describe all the features of COM-AND (which are
  409.        available within CCOLOR if used), or any other communications
  410.        program used.  From time-to-time the assumption will be made
  411.        that COM-AND is used as the communications program, to high-
  412.        light the interaction between CCOLOR and COM-AND.
  413.  
  414.  
  415.        Please do not take it that COM-AND is the only comm program
  416.        possible to use.  Refer to the documentation provided with your
  417.        favorite comm program for a full discussion of its function and
  418.        features.  They won't be available in CCOLOR, however.
  419.  
  420.  
  421.        Appendices here will provide details for very interested readers.
  422.  
  423.  
  424.  
  425.  
  426. Version 1.3: 910724
  427.  
  428. CCOLOR: IBM PC Conference Color                      Page   2
  429.  
  430.  
  431. II.    Running the program
  432.  
  433.  
  434.     CCOLOR is an accessory program, and may be entered in one of three
  435.     ways: (1) it may be invoked through the accessory menu of the comm
  436.     program COM-AND, (2) CCOLOR may be loaded itself (in which case it
  437.     will need to be able to load COM-AND) and (3) it may be loaded
  438.     'piggyback' (intended for use with the DOS gateway of other
  439.     communications programs.  Each method is useful and will be
  440.     discussed separately.
  441.  
  442.  
  443.     A. Loading through COM-AND
  444.  
  445.  
  446.        COM-AND is invoked at the DOS prompt with the command:
  447.  
  448.        ------------------------------------------------------
  449.        "d>" COM-AND <options>
  450.  
  451.        Where "d>" is the DOS prompt, and
  452.          <options> is (<parm> (<parm> ...))
  453.          where <parm> is either a switch or a parameter
  454.  
  455.        Refer to Appendix A of the COM-AND document for a discussion
  456.        of switches and parameters.
  457.        ------------------------------------------------------
  458.  
  459.  
  460.        Once COM-AND has been loaded, the usual sequence is to dial
  461.        a network service using COM-AND's dialing directory or script
  462.        language.  When connection has been established, logon achieved,
  463.        and a conference area entered, then CCOLOR may be selected using
  464.        the F1 Accessories menu.
  465.  
  466.  
  467.        COM-AND defines an 'accessory' as:
  468.  
  469.        o       A name which is displayed in the menu (as you like)
  470.        o       A subdirectory for use during the accessory (optional)
  471.        o       A script file to be performed (optional)
  472.        o       A program to be loaded - along with parameters (optional)
  473.  
  474.        COM-AND was supplied with several accessory menu entries.  You
  475.        must create a new entry for CCOLOR with the 'r' subcommand.  Once
  476.        loaded, CCOLOR is an independent program, using the comm link
  477.        established by COM-AND, and also many of the COM-AND functions.
  478.        CCOLOR is 'integrated' into COM-AND.
  479.  
  480.  
  481.        Note that settings (echo/blank line suppression/logging etc) made
  482.        in COM-AND carry over to the accessory when it is loaded, and
  483.        settings made in the accessory carry over to COM-AND when the
  484.        accessory terminates.  Alt-X terminates both COM-AND and CCOLOR.
  485.  
  486.  
  487. Version 1.3: 910724
  488.  
  489. CCOLOR: IBM PC Conference Color                      Page   3
  490.  
  491.  
  492. II.    Running the program (continued)
  493.  
  494.  
  495.     B. Loading CCOLOR directly
  496.  
  497.  
  498.        CCOLOR may be invoked at the DOS prompt with the command:
  499.  
  500.        ------------------------------------------------------
  501.        "d>" CCOLOR <options>
  502.  
  503.        Where "d>" is the DOS prompt, and
  504.          <options> is (<parm> (<parm> ...))
  505.          where <parm> is either a switch or a parameter (except /P)
  506.  
  507.        Refer to Appendix A of this document for a full description of
  508.        switches and parameters.
  509.        ------------------------------------------------------
  510.  
  511.  
  512.        When CCOLOR is run from the DOS prompt without the '/P' switch,
  513.        it looks for the COM-AND program on the current subdirectory (or
  514.        in the subdirectory indicated by a 'COM-AND=' environment vari-
  515.        able).  CCOLOR will not run unless it can find COM-AND (unless
  516.        '/P' is specified) .  CCOLOR loads COM-AND and execution proceeds
  517.        on the CRT (COM-AND side) of the program.
  518.  
  519.  
  520.        Again, the usual sequence is to dial a network service using
  521.        COM-AND's dialing directory or script language.  When connection
  522.        has been established, logon achieved, and a conference area
  523.        entered, then switch to the gaming side with the F1 key.
  524.  
  525.  
  526.        Loaded this way, the F1 key simply serves as a hot key to switch
  527.        between the two sides of the program (CCOLOR and COM-AND).  No
  528.        menu of additional accessories is available.  All other features
  529.        of COM-AND are available, however.  Again, Alt-X terminates both
  530.        COM-AND and CCOLOR.
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548. Version 1.3: 910724
  549.  
  550. CCOLOR: IBM PC Conference Color                      Page   4
  551.  
  552.  
  553. II.    Running the program (continued)
  554.  
  555.  
  556.     C. Loading CCOLOR Piggyback
  557.  
  558.  
  559.        CCOLOR may be run piggyback as follows:
  560.  
  561.        ------------------------------------------------------
  562.        "d>" CCOLOR /P COMx <speed> <other options>
  563.  
  564.        where COMx = COM1, COM2, COM3 or COM4 and
  565.           <speed> = 300, 1200, 2400, 4800, 9600
  566.  
  567.        Refer to Appendix A of this document for a full description
  568.        of other options.
  569.        ------------------------------------------------------
  570.  
  571.        For example:
  572.  
  573.            C> CCOLOR /P COM1 2400
  574.  
  575.  
  576.        Used in this manner, CCOLOR 'picks-up' a comm line already
  577.        opened and in use by another program.  The 'COMx' and '<speed>'
  578.        parameters are not strictly necessary; however, their use is
  579.        recommended unless you ALWAYS use the same comm port and line-
  580.        speed on all systems wherever you go.
  581.  
  582.  
  583.        Note that Alt-X terminates CCOLOR and simply returns you to
  584.        DOS when CCOLOR is loaded piggyback.  Alt-X terminates both
  585.        CCOLOR and COM-AND when the program set is run without /P.
  586.  
  587.  
  588.        Once back at the DOS prompt, you must return to the comm program
  589.        you originally gatewayed - type 'EXIT' at the DOS prompt if your
  590.        gateway was originally to COMMAND.COM.  Refer to the documenta-
  591.        tion provided with your comm program on the appropriate means of
  592.        returning from the DOS shell.
  593.  
  594.  
  595.        Don't forget to return to your comm program if you shelled to DOS
  596.        and loaded CCOLOR with /P!
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609. Version 1.3: 910724
  610.  
  611. CCOLOR: IBM PC Conference Color                      Page   5
  612.  
  613.  
  614. III.    CCOLOR Display
  615.  
  616.  
  617.     When the screen is painted, it is divided into several areas.  The
  618.     top line carries the program version and release number, and the
  619.     Main Menu.  The current operating mode (manual or automatic) is
  620.     displayed to the left of the menu.  The region between the top and
  621.     bottom lines is a scrolling region for received text.  A status line
  622.     (and keyboard buffer) take the last line.
  623.  
  624.  
  625.     CCOLOR parses every line of text received for an ID.  If you are not
  626.     in the conference area of one of the supported services (PLINK,
  627.     GEnie, SOURCE, DELPHI, CIS, or TBBS), the results will be 'odd'.
  628.  
  629.  
  630.     In conversation, when a speaker is identified (through the ID or
  631.     handle - see following), lines received from that ID (and successive
  632.     lines) will be displayed with a foreground color selected for that
  633.     particular ID.    In manual mode, you select the foreground color for
  634.     up to 16 speakers.  In automatic mode, CCOLOR assigns a foreground
  635.     color to each new ID.  You can review and revise automatic color
  636.     assignments and save assignments for later sessions.
  637.  
  638.  
  639.     CCOLOR scans received text after the ID for special words.  Words
  640.     which are set off by ("), ('), (*), (_) and (<>) are highlighted in
  641.     a contrasting color.  You may turn off this feature if you wish.
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. Version 1.3: 910724
  671.  
  672. CCOLOR: IBM PC Conference Color                      Page   6
  673.  
  674.  
  675. IV.    Services supported
  676.  
  677.  
  678.     CCOLOR is encoded to work with several network services and multi-
  679.     user systems.  CCOLOR parses every incoming line for an ID.
  680.     CCOLOR's parser is 'automatic', in that you don't have to tell it
  681.     which system to parse.
  682.  
  683.  
  684.     The ID (or handle) parse begins after a carriage return from the
  685.     network.  When an ID of a speaker is identified, the line being
  686.     received changes color.  The text is displayed after the ID - and
  687.     highlights are performed as they are found.  If no ID is identified
  688.     the text is displayed with the color of the last speaker.  Blank
  689.     lines (extra carriage returns issued by the network) are not
  690.     displayed by CCOLOR.
  691.  
  692.  
  693.  
  694.     The CCOLOR parser is only designed to deal with text issued within
  695.     the conversational area of one of the systems.    The parser is
  696.     self-adjusting ...  all of the supported formats will be taken as
  697.     conversation.  [The automatic nature of the parser DOES produce some
  698.     false hits now and then.  Its a tradeoff...]
  699.  
  700.  
  701.     The following pages describe templates for IDs and handles as dis-
  702.     played on various systems (handles are assumed names which replace
  703.     or add to an ID).  I have also included some notes on each system
  704.     and its use with CCOLOR.
  705.  
  706.  
  707.     You may wish to skip to the next chapter - the next pages are dull.
  708.     Just one piece of advice - CCOLOR can only parse received text if
  709.     echo from the host is turned off.  Turn off echo!
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731. Version 1.3: 910724
  732.  
  733. CCOLOR: IBM PC Conference Color                      Page   7
  734.  
  735.  
  736. IV.    Services supported (continued)
  737.  
  738.  
  739.     A. PLINK IDs and handles:
  740.  
  741.           "(" <ID> ") "          an initial "*" identifies handles
  742.  
  743.        Example:  (TARTAN) This is how a line would look on PLINK
  744.  
  745.  
  746.        PLINK does not report (to all in conference) when a customer
  747.        exits.
  748.  
  749.        CCOLOR is best used with echo off (the system doesn't echo what
  750.        you type).  You turn echo off with the command /NOECHO.  The key-
  751.        board buffer (controls pull-down) allows you to see your typing
  752.        locally if you need.
  753.  
  754.  
  755.     B. GEnie IDs and handles:
  756.  
  757.           "<" [Handle] <ID> "> "
  758.  
  759.        Example:  <[Scott] TARTAN> This is how a line would look on GEnie
  760.  
  761.  
  762.        GEnie reports to all present the exit or termination of another
  763.        customer.  CCOLOR version 1.3 does not use the report.
  764.  
  765.        CCOLOR is best used with echo off (the system doesn't echo what
  766.        you type).  GEnie does not normally echo entered characters.  If
  767.        you are echoing characters locally (alt-E) turn it off.  Use the
  768.        keyboard buffer to see your typing.
  769.  
  770.  
  771.     C. SOURCE IDs and aliases (now defunct):
  772.  
  773.            <ID/alias> ": "    -or-   [nn] <ID/alias> ": "
  774.  
  775.        Example:  [22] TARTAN:  This is how a line would look on SOURCE
  776.  
  777.  
  778.        The SOURCE reports to all attending the exit or termination of
  779.        another customer.  CCOLOR version 1.3 does not use the report.
  780.  
  781.        CCOLOR is best used with echo off (the system doesn't echo what
  782.        you type).  The SOURCE allows you to turn off echo by exiting the
  783.        SIG (entering command mode), setting half duplex (-> TERM -HALF)
  784.        and re-entering the SIG.
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792. Version 1.3: 910724
  793.  
  794. CCOLOR: IBM PC Conference Color                      Page   8
  795.  
  796.  
  797. IV.    Services supported (continued)
  798.  
  799.  
  800.     D. CIS handles:
  801.  
  802.           "(" <Band> , <ID> ") "
  803.                where <Band> ::= (A!B)(N!NN)","
  804.  
  805.        Example:  (A1,TARTAN) This is how a line would look on CIS
  806.  
  807.  
  808.        CIS does not report (to all in conference) when a customer exits.
  809.  
  810.        CCOLOR is best used with echo off (the system doesn't echo what
  811.        you type).  You turn echo off with the command /NOECHO.  The key-
  812.        board buffer (controls pull-down) allows you to see your typing
  813.        locally if you need.
  814.  
  815.  
  816.     E. Delphi IDs and handles:
  817.  
  818.           <ID> "> "     where an initial "." identifies handles
  819.  
  820.        Example:  TARTAN> This is how a line would look on Delphi
  821.  
  822.  
  823.        Delphi does not report (to all in conference) when a customer
  824.        exits.
  825.  
  826.        CCOLOR is best used with echo off (the system doesn't echo what
  827.        you type).  I recommend requesting help from an experienced
  828.        Delphi user to do this.
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. Version 1.3: 910724
  854.  
  855. CCOLOR: IBM PC Conference Color                      Page   9
  856.  
  857.  
  858. IV.    Services supported (continued)
  859.  
  860.  
  861.     F. TBBS IDs:
  862.  
  863.           "(" <node> ":" <ID> ") "
  864.  
  865.        Example:  (9:  Scott McGinnis) This is how tbbs looks
  866.  
  867.  
  868.        TBBS does not report (to all in conference) when a customer
  869.        exits.
  870.  
  871.        TBBS is still new to me; TBBS BBS's are multiuser (up to 16 lines
  872.        to a BBS), and provide a very comfortable conferencing facility.
  873.        I haven't discovered yet how to turn local echo off.  CCOLOR is
  874.        best used with echo off - if there is no such facility, I am sure
  875.        one will be added, just to keep the reading easy.
  876.  
  877.  
  878.     G. PROTOCALL IDs and handles (now defunct):
  879.  
  880.            "<" nn.nn <ID> ">"
  881.  
  882.        Example:  <04.21 TARTAN> This is how PROTOCALL looks
  883.  
  884.  
  885.        PROTOCALL reports to all attending the exit or termination of
  886.        another customer and various materializations and dematerializ-
  887.        ations.  CCOLOR version 1.3 does not use the report.
  888.  
  889.        CCOLOR is best used with echo off (the system doesn't echo what
  890.        you type).  You toggle echo off and back on with the command /ECHO.
  891.        The keyboard buffer (controls pull-down) allows you to see your
  892.        typing locally if you need.
  893.  
  894.        I am well aware that PROTOCALL is no more.  However, the parser
  895.        still parses it.  Who knows what'll come?
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914. Version 1.3: 910724
  915.  
  916. CCOLOR: IBM PC Conference Color                      Page  10
  917.  
  918.  
  919. V.    CCOLOR Commands using COM-AND
  920.  
  921.  
  922.     When CCOLOR is loaded with COM-AND the following Alt'd keys are
  923.     available:
  924.  
  925.     F1    Switch between text (CRT) and color modes.
  926.     F7    Toggle transcripting.
  927.     F8    Toggle keyboard buffer chat mode.
  928.     F9    Toggle log hold (if logging is enabled).
  929.     F10    Help screen.  All currently implemented commands are
  930.         summarized on this screen.  Any command may be executed
  931.         directly while this screen is displayed.
  932.  
  933.     Alt-F10 DOS Gateway.  If there is sufficient memory available, and
  934.         if the environment variable "COMSPEC" identifies a valid
  935.         .COM or .EXE file, CCOLOR will load the program and execute
  936.         it.  This is used to load a second copy of COMMAND.COM for
  937.         access to DOS while a communication session is in progress.
  938.  
  939.     Ctl-End Send a Break.  This sends a true 'break' signal.
  940.  
  941.     Alt-A    Toggle chat mode.
  942.  
  943.     Alt-B    Redisplay (backscreen).  This backscreen function is compati-
  944.         ble with COM-AND version 2.8 and after.  It is NOT compatible
  945.         with COM-AND versions prior to 2.8.
  946.  
  947.     Alt-C    Clear the screen.
  948.  
  949.     Alt-D    Dialing directory.
  950.  
  951.     Alt-E    Toggle echo (full/half duplex).  This function is also
  952.         invoked through the dialing directory (echo on).
  953.  
  954.     Alt-F    File directory.  A mask is required - just as DOS DIR
  955.         command.
  956.  
  957.     Alt-G    Toggle blank line suppression.
  958.  
  959.     Alt-H    Hang-up.  Hang-up the phone.
  960.  
  961.     Alt-I    Program information.  Author information.  Propaganda.
  962.  
  963.     Alt-L    Toggle CGA/EGA modes (if you have an EGA).
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975. Version 1.3: 910724
  976.  
  977. CCOLOR: IBM PC Conference Color                      Page  11
  978.  
  979.  
  980. V.    CCOLOR Commands using COM-AND (continued)
  981.  
  982.  
  983.     Alt-M    Define a macro for Alt-0 through Alt-9.
  984.  
  985.         Note: Although this menu can be used from either COM-AND or
  986.         accessory, macros are defined through COM-AND and changes
  987.         will be made on the COM-AND side.
  988.  
  989.     Alt-O    Options.  Set controlling flags for COM-AND.
  990.  
  991.         Note: Although this menu can be used from either COM-AND or
  992.         accessory, it really only effects COM-AND settings.
  993.  
  994.     Alt-P    Comm Parameters.  Set baud rate, parity, number of data and
  995.         stop bits for use when COM-AND is initially loaded.  These
  996.         settings are overridden by run-time switches.  Whatever the
  997.         current setting, the dialing directory overrides when used.
  998.  
  999.         Note: Although this menu can be used from either COM-AND or
  1000.         accessory, it really only effects COM-AND settings.  Each
  1001.         accessory has an Alt-P function as well accessible only when
  1002.         the accessory is loaded with the '/P' switch.
  1003.  
  1004.     Alt-R    Redial the last number dialed.    The program will redial the
  1005.         last number dialed number until the function is terminated
  1006.         (with ESC), or connection is made.
  1007.  
  1008.     Alt-S    Setup.    Define initial program values, such as Modem initial-
  1009.         ization, the Modem Hangup sequence, and file names.
  1010.  
  1011.         Note: Although this menu can be used from either COM-AND or
  1012.         accessory, it really only effects COM-AND settings.  Each
  1013.         accessory has an Alt-S function as well which may or may not
  1014.         be accessible when COM-AND is loaded.
  1015.  
  1016.     Alt-T    Elapsed time.  The time the program was loaded, and the time
  1017.         the last call (Alt-C or Alt-R) was placed are displayed.
  1018.  
  1019.     Alt-X    Exit the program.  The program may or may not hangup the
  1020.         phone, depending on the modem.    Note: COM-AND is also
  1021.         terminated, no matter how you loaded CCOLOR and COM-AND.
  1022.  
  1023.     Alt-Z    Toggle parity mask.  The high bit mask is used only for text
  1024.         received and displayed.
  1025.  
  1026.     Alt-0/9 Send a Macro.  A string of characters defined through the
  1027.         Alt-M command described above is transmitted.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036. Version 1.3: 910724
  1037.  
  1038. CCOLOR: IBM PC Conference Color                      Page  12
  1039.  
  1040.  
  1041. VI.    CCOLOR Commands Standalone
  1042.  
  1043.  
  1044.     When CCOLOR is loaded standalone (piggyback, /P) only the following
  1045.     Alt'd keys are active:
  1046.  
  1047.     Alt-C    Toggle chat mode.
  1048.  
  1049.     Alt-C    Screen Clear.  Clear the text area.
  1050.  
  1051.     Alt-J    Color.    This menu allows setting of colors for menues, the
  1052.         status line, and for the text area during manual mode.
  1053.  
  1054.     Alt-L    Toggle CGA/EGA modes (if you have an EGA).
  1055.  
  1056.     Alt-S    Setup.    This menu allows setting a defaults used by CCOLOR.
  1057.         It is also available through the 'Controls' pull-down.
  1058.  
  1059.     Alt-P    Set Comm Parms.  This menu provides a way to change default
  1060.         communications parameters used by CCOLOR ONLY when it is run
  1061.         piggyback.  It is therefore only available when CCOLOR is
  1062.         run piggyback.
  1063.  
  1064.     Alt-X    Exit the program.  In this case (piggyback) only CCOLOR is
  1065.         terminated.  You are returned to DOS.
  1066.  
  1067.  
  1068.     When used in this manner, the pull-down menues are still available,
  1069.     of course.  Transcripting is the only function obtained through a
  1070.     pull-down that is inhibited when CCOLOR is run piggyback.
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097. Version 1.3: 910724
  1098.  
  1099. CCOLOR: IBM PC Conference Color                      Page  13
  1100.  
  1101.  
  1102. VII.    CCOLOR Main Menu
  1103.  
  1104.  
  1105.     On the top line of the display in CCOLOR there is a menu of key-
  1106.     words.    A keyword is selected (with the cursor keys or a mouse),
  1107.     and a submenu pulled-down (with the return or right mouse button).
  1108.     Submenu items are selected (again, with the cursor keys or a mouse),
  1109.     and executed (with the return, space bar, or left mouse button).
  1110.  
  1111.  
  1112.     Top-line menu items are selected with the Cursor right/left keys or
  1113.     right and left motion with the mouse.  When the cursor key is de-
  1114.     pressed, the next menu item (in a circular manner) is highlighted.
  1115.     The highlighted keyword is 'selected'.
  1116.  
  1117.  
  1118.     A submenu is pulled-down with the Cursor-down key (or End, or PgDn,
  1119.     or the left mouse button).  A submenu item is selected from a pull-
  1120.     down when it is highlighted by pressing the Cursor-down/up keys re-
  1121.     petitively.  When the Cursor key is depressed, the next submenu item
  1122.     (again in a circular manner) is highlighted.  The highlighted keyword
  1123.     is 'selected'.
  1124.  
  1125.  
  1126.     A selected submenu item is executed with a Carriage Return.  That's
  1127.     the key with the silly arrow.  When a submenu item is executed, the
  1128.     pull-down is released (it goes back up?).  Hitting the Space-bar or
  1129.     the left mouse button will also execute the selected item.
  1130.  
  1131.  
  1132.     A pull-down is released without executing any item with any of the
  1133.     following keys:  ESC, Home, PgUp, or right mouse button.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158. Version 1.3: 910724
  1159.  
  1160. CCOLOR: IBM PC Conference Color                      Page  14
  1161.  
  1162.  
  1163. VII.    CCOLOR Main Menu (continued)
  1164.  
  1165.  
  1166.     A. Controls
  1167.  
  1168.        The 'Controls' pulldown allows you to select certain
  1169.        control functions.  Controls are:
  1170.  
  1171.        .  You may playback (and view) a saved conference
  1172.        .  Transcripting may be turned on and off (if you
  1173.           loaded CCOLOR with COM-AND).
  1174.        .  Turn keyboard display on and off.
  1175.        .  Turn transcript hold on and off.
  1176.        .  Invoke CCOLOR's Setup menu (Alt-S invokes COM-AND's
  1177.           Setup menu if COM-AND is loaded).
  1178.        .  Invoke CCOLOR's Color menu (Alt-J invokes COM-AND's
  1179.           Color menu if COM-AND is loaded).
  1180.  
  1181.  
  1182.     B. Settings
  1183.  
  1184.        The 'Settings' pulldown allows you change program settings:
  1185.  
  1186.        .  Set auto colors (you may not want all possible colors used
  1187.           ... you may select the colors applied in automatic mode)
  1188.  
  1189.        .  Set manual mode
  1190.        .  Set automatic mode
  1191.  
  1192.     C. Notes
  1193.  
  1194.        The 'Notes' pulldown allows you to:
  1195.  
  1196.        .  Review (and edit) IDs seen by the automatic parser
  1197.  
  1198.        .  Save your current manual settings
  1199.        .  Save your current automatic ID assignments
  1200.        .  Load a new notes file.
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219. Version 1.3: 910724
  1220.  
  1221. CCOLOR: IBM PC Conference Color                      Page  15
  1222.  
  1223.  
  1224. VIII.    The Notes file
  1225.  
  1226.  
  1227.     CCOLOR tries to load a 'Notes' file when CCOLOR is loaded.  The
  1228.     Notes file name is set though the Defaults menu (Use Controls pull-
  1229.     down, or if piggyback, Alt-S).    The Notes file name may also be set
  1230.     with the /F option at run-time (see appendix A).
  1231.  
  1232.  
  1233.     The notes file is used to save manual and automatic assignments from
  1234.     use to use.  CCOLOR automatically loads the Notes file when CCOLOR
  1235.     is loaded.  CCOLOR only saves settings to the notes file when
  1236.     explicitly directed to do so (use the Notes pulldown).
  1237.  
  1238.  
  1239.     The manual mode of operation allows up to 16 IDs to be identified
  1240.     (with the color you select for that ID).  The automatic mode allows
  1241.     up to 500 IDs to be preserved across sessions.
  1242.  
  1243.  
  1244.     Users of multiple systems will find the /F switch convenient.  Each
  1245.     system can have its own Notes file, e.g. PLINK.NOT, GENIE.NOT, and
  1246.     so on.    When CCOLOR is loaded, the particular notes file is
  1247.     specified with the /F switch, e.g.
  1248.  
  1249.  
  1250.         d> CCOLOR /FPLINK.NOT
  1251.         d> CCOLOR /FGENIE.NOT
  1252.  
  1253.         and so on...
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280. Version 1.3: 910724
  1281.  
  1282. CCOLOR: IBM PC Conference Color                      Page  16
  1283.  
  1284.  
  1285. IX.    Manual mode
  1286.  
  1287.  
  1288.     CCOLOR defaults automatic mode when it is loaded (unless you turn
  1289.     off automatic color assignment through the defaults menu or the /M
  1290.     switch).  Select manual mode from the 'Settings' pulldown, or
  1291.     through the defaults menu (Alt-S).
  1292.  
  1293.  
  1294.     In manual mode, all received text is displayed using the foreground
  1295.     color specified in the Colors menu (Alt-J), except for IDs listed in
  1296.     the manual mode table.    Text from the selected IDs is displayed in a
  1297.     selected color.  When you select manual mode from the 'Settings'
  1298.     pulldown, the manual mode table of IDs is presented for editing.
  1299.  
  1300.  
  1301.     Editing the table consists of specifying IDs and selecting colors
  1302.     for each ID.  You may delete an ID from the table simply by entering
  1303.     a blank ID.  You may clear the entire table with one of the menu
  1304.     selections.
  1305.  
  1306.  
  1307.     The current Manual mode table is saved to the Notes file for another
  1308.     session's use with the 'Save Manual settings' of the 'Notes' pull-
  1309.     down.  The Manual mode table is initialized from the notes file
  1310.     specified when CCOLOR was loaded (specified either through the
  1311.     Defaults menu of the /F switch).
  1312.  
  1313.  
  1314.     When CCOLOR is loaded with COM-AND, you have the use of a backscreen
  1315.     function (Alt-B).  The backscreen is comprised of all text received
  1316.     by COM-AND up to the buffer size set through COM-AND's Defaults menu
  1317.     (64K).    [Even text received before CCOLOR was loaded is accessible
  1318.     to CCOLOR, but saved as it was displayed... not highlighted by the
  1319.     CCOLOR function.]
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341. Version 1.3: 910724
  1342.  
  1343. CCOLOR: IBM PC Conference Color                      Page  17
  1344.  
  1345.  
  1346. X.    Automatic mode
  1347.  
  1348.  
  1349.     CCOLOR defaults automatic mode when it is loaded (unless you turn
  1350.     off automatic color assignment through the defaults menu or the /M
  1351.     switch).  Automatic modes and Manual modes are also selected from
  1352.     the 'Settings' pulldown.
  1353.  
  1354.  
  1355.     In automatic mode, all received text is parsed for an ID.  Colors
  1356.     are assigned to each new ID recognized.  Text is displayed in the
  1357.     selected color.  The palette of colors used in automatic mode can be
  1358.     set through the 'Settings' pulldown.
  1359.  
  1360.  
  1361.     The list of IDs and colors is displayed through the  'Notes' pull-
  1362.     down.  The list may be edited through the same function.  Pages of
  1363.     the list - 16 IDs at a time - are displayed.  The INS key begins the
  1364.     process of editing.  Highlight an ID from the page with the cursor
  1365.     down key (or INS key).    Select the ID with the enter key (the broken
  1366.     arrow).  You may set the color of the ID, or delete it at this
  1367.     point.
  1368.  
  1369.  
  1370.     The current Automatic mode table is saved to the Notes file for
  1371.     another session's use with the 'Save Auto settings' of the 'Notes'
  1372.     pulldown.  The Automatic mode table is initialized from the notes
  1373.     file specified when CCOLOR was loaded (specified either through the
  1374.     Defaults menu of the /F switch).
  1375.  
  1376.  
  1377.     When CCOLOR is loaded with COM-AND, you have the use of a backscreen
  1378.     function (Alt-B).  The backscreen is comprised of all text received
  1379.     by COM-AND up to the buffer size set through COM-AND's Defaults menu
  1380.     (64K).    [Even text received before CCOLOR was loaded is accessible
  1381.     to CCOLOR.  Text received prior to CCOLOR is not highlighted.]
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Version 1.3: 910724
  1403.  
  1404. CCOLOR: IBM PC Conference Color                      Page  18
  1405.  
  1406.  
  1407. XI.    Program Configuration (Alt-S, and Alt-P)
  1408.  
  1409.  
  1410.     A. Setup Screen (Alt-S)
  1411.  
  1412.        1. Files
  1413.  
  1414.           . Default Notes file
  1415.  
  1416.         When you save a position, you will be asked for a file name.
  1417.         The file name specified here is used if you enter a blank
  1418.         save file name to this query.
  1419.  
  1420.           . Default Log
  1421.  
  1422.         This file name will be used when you request transcripting
  1423.         and enter a blank in response to the log file name query.
  1424.  
  1425.        2. Timings and Values
  1426.  
  1427.           . Break delay
  1428.  
  1429.         As noted above, the break delay is controlled through the
  1430.         Millisecond loop value.  This value "break delay"
  1431.         specifies the number of "milliseconds" the comm line is
  1432.         held when a break is issued (Cntl-END).
  1433.  
  1434.        3. Flags
  1435.  
  1436.           . Use BIOS for screen saves
  1437.  
  1438.         CCOLOR executes with alpha screen, so it can use BIOS
  1439.         routines for screen saves.  BIOS is slower (menues pop-up
  1440.         and drop more slowly) than the default method, but some
  1441.         machines and some operating environments will require
  1442.         that you set this on (use /C in the run command).
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463. Version 1.3: 910724
  1464.  
  1465. CCOLOR: IBM PC Conference Color                      Page  19
  1466.  
  1467.  
  1468. XI.    Program Configuration (continued)
  1469.  
  1470.  
  1471.     A. Setup Screen (Alt-S) (continued)
  1472.  
  1473.        3. Flags (continued)
  1474.  
  1475.           . Automatic assignment
  1476.  
  1477.         CCOLOR loads in automatic mode unless you turn it off with
  1478.         this flag.  When this flag is off, CCOLOR is loaded in
  1479.         manual mode.
  1480.  
  1481.           . Highlight special words
  1482.  
  1483.         CCOLOR will scan received text for delimited words, and high-
  1484.         light them is a contrasting color.  You may turn this feature
  1485.         (or back on) here.
  1486.  
  1487.           . Initial advert
  1488.  
  1489.         Turn off the advert after you've seen it.  Just before you
  1490.         register...  This only effects standalone usage.
  1491.  
  1492.           . Chat window
  1493.  
  1494.         This setting allows the chat window to be enabled whenever
  1495.         CCOLOR is run.
  1496.  
  1497.           . Keyboard buffer
  1498.  
  1499.         This setting allows the keyboard buffer to be enabled when-
  1500.         ever CCOLOR is run.
  1501.  
  1502.           . Exit Query
  1503.  
  1504.         Some people disdain the query "do you really and truly mean
  1505.         it" when they type Alt-X.  Some feel it mandatory.  CCOLOR
  1506.         is distributed with exit query disabled.  You may enable it,
  1507.         if you're so inclined.  This only effects standalone usage.
  1508.  
  1509.  
  1510.        4. Save
  1511.  
  1512.           You may change values for one execution of CCOLOR, or you
  1513.           may change them for all subsequent executions of CCOLOR.    If
  1514.           you save values, the values you've saved will be used the
  1515.           next time you run CCOLOR.
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524. Version 1.3: 910724
  1525.  
  1526. CCOLOR: IBM PC Conference Color                      Page  20
  1527.  
  1528.  
  1529. XI.    Program Configuration (continued)
  1530.  
  1531.  
  1532.     B. Communications Parameters (Alt-P)
  1533.  
  1534.        1. Rate + Parity + Data bits + Stop Bits
  1535.  
  1536.           Baud rate, parity, number of data bits and number of stop bits
  1537.           are specified in combination through the first 10 selections
  1538.           on the Alt-P window.  These selections are the only way you
  1539.           may specify baud rate.  Other parameters (parity, data bits,
  1540.           and stop bits) may be set individually (below).
  1541.  
  1542.           Do not change the current setting after you've connected to a
  1543.           service.    Make your setting here before you use CCOLOR
  1544.           on-line.
  1545.  
  1546.        2. Parity, Data bits and Stop bits
  1547.  
  1548.           Individual settings for parity, number of data bits and number
  1549.           of stop bits comprise the next 7 items of this menu.  You also
  1550.           set these values when you create a dialing directory entry.
  1551.  
  1552.           Again - do not change the current setting after you've
  1553.           connected to a service.  The settings on this screen are
  1554.           effective only when CCOLOR is run standalone.  Changing a
  1555.           setting here could disconnect you.
  1556.  
  1557.        3. COM ports
  1558.  
  1559.           The last four items on this menu are the candidates for COM
  1560.           ports.  Select the appropriate port for your modem.  This item
  1561.           is usually selected once, and then left alone.
  1562.  
  1563.        4. Save
  1564.  
  1565.           You save the current settings for the next execution of CCOLOR
  1566.           through the "Save" selection.  Settings are saved to disk.
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585. Version 1.3: 910724
  1586.  
  1587. CCOLOR: IBM PC Conference Color                      Page  21
  1588.  
  1589.  
  1590. XI.    Program Configuration (continued)
  1591.  
  1592.  
  1593.     C. Colors (Alt-J)
  1594.  
  1595.        You may set foreground and background colors for
  1596.  
  1597.           (1) the CRT text area (in manual mode),
  1598.  
  1599.           (2) the status line, and
  1600.  
  1601.           (3) the main menu and important menus (queries are set to
  1602.           black on white for contrast).
  1603.  
  1604.  
  1605.        The background color for the table is may not be changed.
  1606.  
  1607.  
  1608.        The color names are those used in the IBM Technical reference;
  1609.        if you have different names for some of the color values, I
  1610.        apologize.  My wife and I have argued for years over 'beige'.
  1611.  
  1612.  
  1613.        Like other option menus, you can experiment with settings.
  1614.        Unless you save your settings, they are lost when the program
  1615.        terminates.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646. Version 1.3: 910724
  1647.  
  1648. CCOLOR: IBM PC Conference Color                      Page  22
  1649.  
  1650.  
  1651. XII.    Program Requirements
  1652.  
  1653.  
  1654.     This program can only function on an IBM PC or DOS compatible
  1655.     machine.
  1656.  
  1657.  
  1658.     CCOLOR supports CGA, EGA.  It may be used with an MDA or Hercules
  1659.     monitor, with a considerable loss of functionality.  CCOLOR uses a
  1660.     Microsoft Mouse if one is available (not well, but it'll certainly
  1661.     get better).
  1662.  
  1663.  
  1664.     CCOLOR disk I/O is done through the 'Handle' oriented I/O routines
  1665.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  1666.  
  1667.  
  1668.     CCOLOR (version 1.3) requires 81K for itself.  So you need 128.
  1669.     To take advantage of the DOS Gateway (use another comm program) or
  1670.     to use COM-AND, you'll need 384K.
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707. Version 1.3: 910724
  1708.  
  1709. CCOLOR: IBM PC Conference Color                      Page  23
  1710.  
  1711.  
  1712. XIII.    Program and Author Information
  1713.  
  1714.  
  1715.     This program was written using Microsoft Macro-Assembler.  The
  1716.     author likes assembler.  Assembly language is an entirely appro-
  1717.     priate vehicle for some of the program, and a not-inappropriate
  1718.     vehicle for the rest of it.  Everything, in moderation...
  1719.  
  1720.  
  1721.     The author of this program is R.  Scott McGinnis of Chicago,
  1722.     Illinois.  PLINK and GEnie ID:    TARTAN.  Comment and suggestions
  1723.     (and criticism in moderation) are welcomed:
  1724.  
  1725.              CABER Software
  1726.              R. (Scott) McGinnis
  1727.              P.O. Box 3607 Mdse Mart
  1728.              Chicago, IL 60654-0607
  1729.  
  1730.  
  1731.     I thank my wife Elizabeth - I pitched this idea to her, and we both
  1732.     got so excited I coded up a demonstration the next day.  I've been
  1733.     using it addictedly since then.  She supported me literally and
  1734.     figuratively in this effort.  Without her love and goodwill I'd be
  1735.     pretty sour by now.
  1736.  
  1737.  
  1738.     This program (Version 1.3) may be distributed freely with the caveat
  1739.     that the Author information displayed at program termination is not
  1740.     removed.  If the program is found entertaining or useful, a regis-
  1741.     tration of $50.00 is required.    Should response warrant it, I will
  1742.     continue to develop and support this product.
  1743.  
  1744.  
  1745.     Most of the hardware names and software names in this document are
  1746.     trademarks or trade names of specific manufacturers.
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768. Version 1.3: 910724
  1769.  
  1770. CCOLOR: IBM PC Conference Color                      Page  24
  1771.  
  1772.  
  1773. A.    Switches and parameters
  1774.  
  1775.  
  1776.     Program Switches:
  1777.  
  1778.     /C 'Compatible': BIOS is used for screen saves/restores, as required
  1779.         by certain machines and certain operating environments.
  1780.  
  1781.     /E 'EGA': An EGA, if available will be used for the display of a
  1782.         43 line screen.  The size of text is reduced, but for people
  1783.         who like to talk, its a great thing.
  1784.  
  1785.     /F 'File': You may specify a Notes file (other than the Defaults
  1786.         menu specification) with the /F switch followed by a valid file
  1787.         name.  The name is limited to 26 characters in length.
  1788.  
  1789.     /M 'Manual mode': CCOLOR defaults to automatic mode when it is
  1790.         loaded.  This flag sets manual mode at run-time.
  1791.  
  1792.     /P  'Piggyback':  CCOLOR will open the COM port in such a manner as
  1793.         to retain another program's already opened line.  When CCOLOR is
  1794.         exited, the previous state is restored.  This is for use with
  1795.         other communications programs having a DOS Gateway (e.g.
  1796.         PROCOMM).
  1797.  
  1798.     /X  'Debug mode': This switch enables certain resident debugging
  1799.         keys.  I do not recommend you use it.
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829. Version 1.3: 910724                           Appendices
  1830.  
  1831. CCOLOR: IBM PC Conference Color                      Page  25
  1832.  
  1833.  
  1834. A.    Switches and Parameters (continued)
  1835.  
  1836.  
  1837.     Program parameters:
  1838.  
  1839.        COM1     CCOLOR uses the COM1 port
  1840.        COM2     CCOLOR uses the COM2 port
  1841.        COM3     CCOLOR uses the COM3 port
  1842.        COM4     CCOLOR uses the COM4 port
  1843.  
  1844.        300        CCOLOR uses port at 300 baud
  1845.        1200     CCOLOR uses port at 1200 baud
  1846.        2400     CCOLOR uses port at 2400 baud
  1847.        4800     CCOLOR uses port at 4800 baud
  1848.        9600     CCOLOR uses port at 9600 baud
  1849.  
  1850.        EVEN     CCOLOR uses port with even parity
  1851.        ODD        CCOLOR uses port with odd parity
  1852.        NONE     CCOLOR uses port with no parity
  1853.  
  1854.        DATA7    CCOLOR transmits/receives 7 data bits
  1855.        DATA8    CCOLOR transmits/receives 8 data bits
  1856.  
  1857.        STOP1    CCOLOR uses and expects 1 stop bit
  1858.        STOP2    CCOLOR uses and expects 2 stop bits
  1859.  
  1860.  
  1861.     Program switches require no delimiters.  Parameters when contiguous
  1862.     must be preceded by a blank.  For example:
  1863.  
  1864.     A> CCOLOR 1200        Run the program for 1200 baud communications
  1865.     A> CCOLOR /P1200    Piggyback, 1200 baud
  1866.     A> CCOLOR /P 1200    Piggyback, 1200 baud
  1867.  
  1868.  
  1869.     Program defaults are:
  1870.  
  1871.     A> CCOLOR COM2 300 EVEN DATA7 STOP1
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890. Version 1.3: 910724                           Appendices
  1891.  
  1892. CCOLOR: IBM PC Conference Color                      Page  26
  1893.  
  1894.  
  1895. B.    Files
  1896.  
  1897.  
  1898.     Program files:    CCOLOR expects the following files on the default
  1899.     drive (and subdirectory)
  1900.  
  1901.     CCOLOR.DFT    Parameter save area (Alt-S, Alt-J and Alt-P)
  1902.  
  1903.  
  1904.     CCOLOR will create this file if it is not found.  CCOLOR will auto-
  1905.     matically update the .DFT file if the program version number is
  1906.     different from the .DFT file version number.  When CCOLOR is loaded,
  1907.     the old file format will be loaded.  A new file will then be created
  1908.     to replace the old file.
  1909.  
  1910.  
  1911.     When a new major (e.g.    1.0, 2.0, ...) is released or when you move
  1912.     CCOLOR from one machine to another the previous .DFT file probably
  1913.     should be purged (and recreated by CCOLOR).
  1914.  
  1915.  
  1916.     CCOLOR also uses (if available) the following files:
  1917.  
  1918.     CCOLOR.NOT    Default Notes file (manual and automatic settings)
  1919.     CCOLOR.LOG    Default log file name
  1920.  
  1921.  
  1922.     Each of these file names may be changed through the ALT-S (Setup)
  1923.     Menu.  CCOLOR currently implements the rule for file names:  If the
  1924.     given file name carries a drive spec (i.e.  C:) or path (sub-
  1925.     directory), the name is taken 'as is'.  If neither condition holds,
  1926.     the default drive and subdirectory are added to the file name.
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951. Version 1.3: 910724                           Appendices
  1952.  
  1953. CCOLOR: IBM PC Conference Color                      Page  27
  1954.  
  1955.  
  1956. C.    Save file structure:
  1957.  
  1958.     0     1     2      3    4     5     6      7    8
  1959.     +-----+-----+-----+-----+-----+-----+-----+-----+---//
  1960.     ! 'C' ! 'C' ! 'O' ! 'L' ! 'O' ! 'R' ! <ver-rev> !   ...
  1961.     +-----+-----+-----+-----+-----+-----+-----+-----+---//
  1962.  
  1963.           8     ...                       22
  1964.       //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---//
  1965.           ! Internal file pointers (manual/automatic sections)  !    ...
  1966.       //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---//
  1967.  
  1968.           22    ...                       358
  1969.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  1970.           ! Manual mode table                  !   ...
  1971.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  1972.  
  1973.           358      360    ...                  11860
  1974.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  1975.           ! Auto_Len  ! Automatic mode table          !   ...
  1976.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  1977.  
  1978.  
  1979.         <Ver-rev>    Binary, Version * 256 + Revision
  1980.         Auto_Len    Size of Auto table used
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012. Version 1.3: 910724                           Appendices
  2013.